
搜索文档...
文档首页
核心文档
快速起步
CLI 快速起步
开发指南
API参考手册
附加文档
教程
高级文档
动画
属性型指令
浏览器支持
组件样式
部署
多级注入器
响应式表单
HTTP 客户端
生命周期钩子
Angular模块 (NgModule)
npm 包
管道
路由与导航
安全
搭建剖析
结构型指令
测试
TypeScript 配置
从 AngularJS 升级
Webpack 简介
烹饪宝典
Angular for TypeScript
TypeScript 配置
Angular 开发者的 TypeScript 配置
TypeScript是Angular应用开发中使用的主语言。 它是JavaScript的“方言”之一，为类型安全和工具化而做了设计期支持。

浏览器不能直接执行TypeScript。它得先用tsc编译器转译(transpile)成JavaScript，而且编译器需要进行一些配置。

本页面会覆盖TypeScript配置与环境的某些方面，这些对Angular开发者是很重要的。具体来说包括下列文件：

tsconfig.json - TypeScript编译器配置。
typings - TypesScript类型声明文件。
tsconfig.json

我们通常会往项目中加入一个TypeScript配置文件(tsconfig.json)，来指导编译器如何生成JavaScript文件。

要了解关于tsconfig.json的详情，请参阅官方提供的 TypeScript wiki。
我们在搭建本地开发环境中创建过如下的tsconfig.json：

tsconfig.json
Copy Code
{
  "compilerOptions": {
    "target": "es5",
    "module": "commonjs",
    "moduleResolution": "node",
    "sourceMap": true,
    "emitDecoratorMetadata": true,
    "experimentalDecorators": true,
    "lib": [ "es2015", "dom" ],
    "noImplicitAny": true,
    "suppressImplicitAnyIndexErrors": true
  }
}
该文件中的选项和标志是写Angular应用程序的基础。

noImplicitAny与suppressImplicitAnyIndexErrors
TypeScript开发者们在noImplicitAny标志应该是true还是false上存在分歧。 这没有标准答案，我们以后还可以修改这个标志。 但是我们的选择会在大项目中产生显著差异，所以它值得讨论一番。

当noImplicitAny标志是false(默认值)时， 如果编译器无法根据变量的用途推断出变量的类型，它就会悄悄的把变量类型默认为any。这就是隐式any的含义。

本文档在环境搭建时将noImplicitAny标志设置为true。

当noImplicitAny标志是true并且TypeScript编译器无法推断出类型时，它仍然会生成JavaScript文件。 但是它也会报告一个错误。 很多饱经沧桑的程序员更喜欢这种严格的设置，因为类型检查能在编译期间捕获更多意外错误。

即使noImplicitAny标志被设置成了true，你也可以把变量的类型设置为any。

如果我们把noImplicitAny标志设置为了true，我们可能会得到隐式索引错。 大多数程序员可能觉得这种错误是个烦恼而不是助力。 我们可以使用另一个标志来禁止它们。

Copy Code
"suppressImplicitAnyIndexErrors":true
本文档在环境搭建时将noImplicitAny标志设置为true。

TypeScript类型定义(typings)

很多JavaScript库，比如jQuery、Jasmine测试库和Angular，会通过新的特性和语法来扩展JavaScript环境。 而TypeScript编译器并不能原生的识别它们。 当编译器不能识别时，它就会抛出一个错误。

我们可以使用TypeScript类型定义文件 —— .d.ts文件 —— 来告诉编译器要加载的库的类型定义。

TypeScript敏感的编辑器借助这些定义文件来显示这些库中各个特性的类型定义。

很多库在自己的npm包中都包含了它们的类型定义文件，TypeScript编译器和编辑器都能找到它们。Angular库也是这样的。 任何Angular应用程序的node_modules/@angular/core/目录下，都包含几个d.ts文件，它们描述了Angular的各个部分。

我们不需要为那些包含了d.ts文件的库获取类型定义文件 —— Angular的所有包都是如此。

lib.d.ts
TypeScript带有一个特殊的声明文件，名为lib.d.ts。该文件包含了JavaScript运行库和DOM的各种常用JavaScript环境声明。

基于--target，TypeScript添加额外的环境声明，例如如果目标为es6时将添加Promise。

因为《快速起步》的目标为es5，所以我们可以重写声明文件列表来包含：

Copy Code
"lib": ["es2015", "dom"]
得益于这项设置，即使编译目标设置为es5，我们也能获得所有的es6类型信息。

安装类型定义文件
遗憾的是，很多库 —— jQuery、Jasmine和Lodash等库 —— 都没有在它们自己的npm包中包含d.ts文件。 幸运的是，它们的作者或社区中的贡献者已经为这些库创建了独立的d.ts文件，并且把它们发布到了一个众所周知的位置。

我们还可以通过npm来使用@types/*范围化包来安装这些类型信息， 而TypeScript自从2.0开始，可以自动识别它们。

比如，要安装jasmine的类型信息，我们可以执行npm install @types/jasmine --save-dev。

我们在“快速起步”中指定过两个类型定义文件（d.ts）：

jasmine是Jasmine测试框架的类型定义
node是为了在nodejs环境中引用对象的代码提供的类型定义。在webpack页面可以看到例子。
“快速起步”本身不需要这些类型定义，但是文档中的很多例子都需要。

资源库

关于
书籍与培训
工具与库
社区
宣传资料
帮助

Stack Overflow
Gitter
Google Group
报告问题
网站反馈
社区

会议
Meetups
Twitter
GitHub
做贡献
其它语种

英文版
Powered by Google ©2010-2017。代码授权方式：MIT-style License。文档授权方式：CC BY 4.0。
本网站由洛阳永欣维护  豫ICP备16019859号-1    